Scenario #6010: Replace Deceased Partner by Community of Heirs

Properties

Required

Given

name value
partnerNumber P-31011
dateOfDeath 2024-11-15
representativeGivenName Lena
representativeFamilyName Stadland
communityOfHeirsPostalAddress “street”: “Im Wischer 14”,
“zipcode”: “22987”,
“city”: “Hamburg”,
“country”: “Germany”
communityOfHeirsOfficePhoneNumber +49 40 666666
communityOfHeirsEmailAddress lena.stadland@example.org

Partner: P-31011

HTTP GET "/api/hs/office/partners/P-31011" \
  -H "Authorization: Bearer $HSADMINNG_JWT_BEARER" \
  `# {` \
  `#   "sub" : "uuid<hsh-alex_superuser>"` \
  `# }`
=> status: 200 OK 
{
  "uuid" : "c3c80fe5-c6e0-4e11-9b63-e472fc768e2c", // Partner: P-31011 - Michelle Matthieu
  "partnerNumber" : "P-31011",
  "partnerRel" : {
    "uuid" : "ed2fbf99-b83d-4513-88dc-18d8229017cf",
    "anchor" : {
      "uuid" : "bb7b76f1-1922-46aa-8c22-468c70c3a9fa", // Person: Hostsharing eG
      "personType" : "LEGAL_PERSON",
      "tradeName" : "Hostsharing eG",
      "salutation" : null,
      "title" : null,
      "givenName" : null,
      "familyName" : null
    },
    "holder" : {
      "uuid" : "42f2f790-db43-4347-93b9-9b2ef60f3c36", // personUuid
      "personType" : "NATURAL_PERSON",
      "tradeName" : null,
      "salutation" : null,
      "title" : null,
      "givenName" : "Michelle",
      "familyName" : "Matthieu-Zhang"
    },
    "type" : "PARTNER",
    "mark" : null,
    "contact" : {
      "uuid" : "adb4df0b-d210-4a0b-bc87-4035b754b6ae", // Contact: Michelle Matthieu
      "caption" : "Michelle Matthieu",
      "postalAddress" : {
        "zipcode" : "22123",
        "country" : "Germany",
        "city" : "Hamburg",
        "street" : "An der Wandse 34",
        "name" : "Michelle Matthieu"
      },
      "emailAddresses" : {
        "main" : "michelle@matthieu.example.org"
      },
      "phoneNumbers" : {
        "mobile" : "+49 152 1234567"
      }
    }
  },
  "details" : {
    "uuid" : "c4d07944-1979-4ceb-970d-48ff83b3acb5",
    "registrationOffice" : null,
    "registrationNumber" : null,
    "birthName" : "Eichbaum",
    "birthPlace" : "Neustadt a.d.R.",
    "birthday" : "1951-03-25",
    "dateOfDeath" : null
  }
}

Even in production data we expect this query to return just a single result.

New Partner-Person+Contact: Erbengemeinschaft Michelle Matthieu-Zhang

HTTP PATCH "/api/hs/office/partners/c3c80fe5-c6e0-4e11-9b63-e472fc768e2c" // Partner: P-31011 \
  -H "Authorization: Bearer $HSADMINNG_JWT_BEARER" \
  `# {` \
  `#   "sub" : "uuid<hsh-alex_superuser>"` \
  `# }` \
  -H 'Content-Type: application/json' \
  --data-binary @- <<EOF
{
  "partnerRel" : {
    "holder" : {
      "personType" : "UNINCORPORATED_FIRM",
      "tradeName" : "Erbengemeinschaft Michelle Matthieu-Zhang"
    },
    "contact" : {
      "caption" : "Erbengemeinschaft Michelle Matthieu-Zhang",
      "postalAddress" : {
        "whatever" : "any key is allowed here",
        "name" : "Erbengemeinschaft Michelle Matthieu-Zhang",
        "co" : "Lena Stadland",
        "street" : "Im Wischer 14",
        "zipcode" : "22987",
        "city" : "Hamburg",
        "country" : "Germany"
      },
      "phoneNumbers" : {
        "office" : "+49 40 666666"
      },
      "emailAddresses" : {
        "main" : "lena.stadland@example.org"
      }
    }
  }
}
EOF
=> status: 200 OK 
{
  "uuid" : "c3c80fe5-c6e0-4e11-9b63-e472fc768e2c", // Partner: P-31011
  "partnerNumber" : "P-31011",
  "partnerRel" : {
    "uuid" : "ed2fbf99-b83d-4513-88dc-18d8229017cf",
    "anchor" : {
      "uuid" : "bb7b76f1-1922-46aa-8c22-468c70c3a9fa", // Person: Hostsharing eG
      "personType" : "LEGAL_PERSON",
      "tradeName" : "Hostsharing eG",
      "salutation" : null,
      "title" : null,
      "givenName" : null,
      "familyName" : null
    },
    "holder" : {
      "uuid" : "406a0fda-d67d-455f-bda8-fc208154c584",
      "personType" : "UNINCORPORATED_FIRM",
      "tradeName" : "Erbengemeinschaft Michelle Matthieu-Zhang",
      "salutation" : null,
      "title" : null,
      "givenName" : null,
      "familyName" : null
    },
    "type" : "PARTNER",
    "mark" : null,
    "contact" : {
      "uuid" : "baf9230c-0999-4738-9bae-8f672fb03f9d",
      "caption" : "Erbengemeinschaft Michelle Matthieu-Zhang",
      "postalAddress" : {
        "zipcode" : "22987",
        "country" : "Germany",
        "city" : "Hamburg",
        "street" : "Im Wischer 14",
        "name" : "Erbengemeinschaft Michelle Matthieu-Zhang",
        "co" : "Lena Stadland",
        "whatever" : "any key is allowed here"
      },
      "emailAddresses" : {
        "main" : "lena.stadland@example.org"
      },
      "phoneNumbers" : {
        "office" : "+49 40 666666"
      }
    }
  },
  "details" : {
    "uuid" : "c4d07944-1979-4ceb-970d-48ff83b3acb5",
    "registrationOffice" : null,
    "registrationNumber" : null,
    "birthName" : "Eichbaum",
    "birthPlace" : "Neustadt a.d.R.",
    "birthday" : "1951-03-25",
    "dateOfDeath" : null
  }
}

Representative-Relation: Lena Stadland for Erbengemeinschaft Michelle Matthieu-Zhang

HTTP POST "/api/hs/office/relations" \
  -H "Authorization: Bearer $HSADMINNG_JWT_BEARER" \
  `# {` \
  `#   "sub" : "uuid<hsh-alex_superuser>"` \
  `# }` \
  -H 'Content-Type: application/json' \
  --data-binary @- <<EOF
{
  "type" : "REPRESENTATIVE",
  "anchor.uuid" : "406a0fda-d67d-455f-bda8-fc208154c584", // Person: Erbengemeinschaft Michelle Matthieu-Zhang
  "holder" : {
    "personType" : "NATURAL_PERSON",
    "givenName" : "Lena",
    "familyName" : "Stadland"
  },
  "contact.uuid" : "baf9230c-0999-4738-9bae-8f672fb03f9d" // Contact: Erbengemeinschaft Michelle Matthieu-Zhang
}
EOF
=> status: 201 CREATED 78218ee8-8577-4710-b6db-e8af28af6752
{
  "uuid" : "78218ee8-8577-4710-b6db-e8af28af6752",
  "anchor" : {
    "uuid" : "406a0fda-d67d-455f-bda8-fc208154c584", // Person: Erbengemeinschaft Michelle Matthieu-Zhang
    "personType" : "UNINCORPORATED_FIRM",
    "tradeName" : "Erbengemeinschaft Michelle Matthieu-Zhang",
    "salutation" : null,
    "title" : null,
    "givenName" : null,
    "familyName" : null
  },
  "holder" : {
    "uuid" : "b4522e29-cad4-4755-81a2-b6bd3383f269",
    "personType" : "NATURAL_PERSON",
    "tradeName" : null,
    "salutation" : null,
    "title" : null,
    "givenName" : "Lena",
    "familyName" : "Stadland"
  },
  "type" : "REPRESENTATIVE",
  "mark" : null,
  "contact" : {
    "uuid" : "baf9230c-0999-4738-9bae-8f672fb03f9d", // Contact: Erbengemeinschaft Michelle Matthieu-Zhang
    "caption" : "Erbengemeinschaft Michelle Matthieu-Zhang",
    "postalAddress" : {
      "zipcode" : "22987",
      "country" : "Germany",
      "city" : "Hamburg",
      "street" : "Im Wischer 14",
      "name" : "Erbengemeinschaft Michelle Matthieu-Zhang",
      "co" : "Lena Stadland",
      "whatever" : "any key is allowed here"
    },
    "emailAddresses" : {
      "main" : "lena.stadland@example.org"
    },
    "phoneNumbers" : {
      "office" : "+49 40 666666"
    }
  }
}

Verify the Updated Partner

HTTP GET "/api/hs/office/partners/P-31011" \
  -H "Authorization: Bearer $HSADMINNG_JWT_BEARER" \
  `# {` \
  `#   "sub" : "uuid<hsh-alex_superuser>"` \
  `# }`
=> status: 200 OK 
{
  "uuid" : "c3c80fe5-c6e0-4e11-9b63-e472fc768e2c", // Partner: P-31011
  "partnerNumber" : "P-31011",
  "partnerRel" : {
    "uuid" : "ed2fbf99-b83d-4513-88dc-18d8229017cf",
    "anchor" : {
      "uuid" : "bb7b76f1-1922-46aa-8c22-468c70c3a9fa", // Person: Hostsharing eG
      "personType" : "LEGAL_PERSON",
      "tradeName" : "Hostsharing eG",
      "salutation" : null,
      "title" : null,
      "givenName" : null,
      "familyName" : null
    },
    "holder" : {
      "uuid" : "406a0fda-d67d-455f-bda8-fc208154c584", // Person: Erbengemeinschaft Michelle Matthieu-Zhang
      "personType" : "UNINCORPORATED_FIRM",
      "tradeName" : "Erbengemeinschaft Michelle Matthieu-Zhang",
      "salutation" : null,
      "title" : null,
      "givenName" : null,
      "familyName" : null
    },
    "type" : "PARTNER",
    "mark" : null,
    "contact" : {
      "uuid" : "baf9230c-0999-4738-9bae-8f672fb03f9d", // Contact: Erbengemeinschaft Michelle Matthieu-Zhang
      "caption" : "Erbengemeinschaft Michelle Matthieu-Zhang",
      "postalAddress" : {
        "zipcode" : "22987",
        "country" : "Germany",
        "city" : "Hamburg",
        "street" : "Im Wischer 14",
        "name" : "Erbengemeinschaft Michelle Matthieu-Zhang",
        "co" : "Lena Stadland",
        "whatever" : "any key is allowed here"
      },
      "emailAddresses" : {
        "main" : "lena.stadland@example.org"
      },
      "phoneNumbers" : {
        "office" : "+49 40 666666"
      }
    }
  },
  "details" : {
    "uuid" : "c4d07944-1979-4ceb-970d-48ff83b3acb5",
    "registrationOffice" : null,
    "registrationNumber" : null,
    "birthName" : "Eichbaum",
    "birthPlace" : "Neustadt a.d.R.",
    "birthday" : "1951-03-25",
    "dateOfDeath" : null
  }
}

Verify the Ex-Partner-Relation

HTTP GET "/api/hs/office/relations?relationType=EX_PARTNER&personUuid=42f2f790-db43-4347-93b9-9b2ef60f3c36" // Person: Michelle Matthieu-Zhang \
  -H "Authorization: Bearer $HSADMINNG_JWT_BEARER" \
  `# {` \
  `#   "sub" : "uuid<hsh-alex_superuser>"` \
  `# }`
=> status: 200 OK 
[ {
  "uuid" : "01d52123-76a3-44b3-89ac-3a3f46f8ce19",
  "anchor" : {
    "uuid" : "406a0fda-d67d-455f-bda8-fc208154c584", // Person: Erbengemeinschaft Michelle Matthieu-Zhang
    "personType" : "UNINCORPORATED_FIRM",
    "tradeName" : "Erbengemeinschaft Michelle Matthieu-Zhang",
    "salutation" : null,
    "title" : null,
    "givenName" : null,
    "familyName" : null
  },
  "holder" : {
    "uuid" : "42f2f790-db43-4347-93b9-9b2ef60f3c36", // Person: Michelle Matthieu-Zhang
    "personType" : "NATURAL_PERSON",
    "tradeName" : null,
    "salutation" : null,
    "title" : null,
    "givenName" : "Michelle",
    "familyName" : "Matthieu-Zhang"
  },
  "type" : "EX_PARTNER",
  "mark" : null,
  "contact" : {
    "uuid" : "baf9230c-0999-4738-9bae-8f672fb03f9d", // Contact: Erbengemeinschaft Michelle Matthieu-Zhang
    "caption" : "Erbengemeinschaft Michelle Matthieu-Zhang",
    "postalAddress" : {
      "zipcode" : "22987",
      "country" : "Germany",
      "city" : "Hamburg",
      "street" : "Im Wischer 14",
      "name" : "Erbengemeinschaft Michelle Matthieu-Zhang",
      "co" : "Lena Stadland",
      "whatever" : "any key is allowed here"
    },
    "emailAddresses" : {
      "main" : "lena.stadland@example.org"
    },
    "phoneNumbers" : {
      "office" : "+49 40 666666"
    }
  }
} ]

Verify the Representative-Relation

HTTP GET "/api/hs/office/relations?relationType=REPRESENTATIVE&personUuid=406a0fda-d67d-455f-bda8-fc208154c584" // Person: Erbengemeinschaft Michelle Matthieu-Zhang \
  -H "Authorization: Bearer $HSADMINNG_JWT_BEARER" \
  `# {` \
  `#   "sub" : "uuid<hsh-alex_superuser>"` \
  `# }`
=> status: 200 OK 
[ {
  "uuid" : "78218ee8-8577-4710-b6db-e8af28af6752", // Representative-Relation: Lena Stadland for Erbengemeinschaft Michelle Matthieu-Zhang
  "anchor" : {
    "uuid" : "406a0fda-d67d-455f-bda8-fc208154c584", // Person: Erbengemeinschaft Michelle Matthieu-Zhang
    "personType" : "UNINCORPORATED_FIRM",
    "tradeName" : "Erbengemeinschaft Michelle Matthieu-Zhang",
    "salutation" : null,
    "title" : null,
    "givenName" : null,
    "familyName" : null
  },
  "holder" : {
    "uuid" : "b4522e29-cad4-4755-81a2-b6bd3383f269", // Person: Lena Stadland
    "personType" : "NATURAL_PERSON",
    "tradeName" : null,
    "salutation" : null,
    "title" : null,
    "givenName" : "Lena",
    "familyName" : "Stadland"
  },
  "type" : "REPRESENTATIVE",
  "mark" : null,
  "contact" : {
    "uuid" : "baf9230c-0999-4738-9bae-8f672fb03f9d", // Contact: Erbengemeinschaft Michelle Matthieu-Zhang
    "caption" : "Erbengemeinschaft Michelle Matthieu-Zhang",
    "postalAddress" : {
      "zipcode" : "22987",
      "country" : "Germany",
      "city" : "Hamburg",
      "street" : "Im Wischer 14",
      "name" : "Erbengemeinschaft Michelle Matthieu-Zhang",
      "co" : "Lena Stadland",
      "whatever" : "any key is allowed here"
    },
    "emailAddresses" : {
      "main" : "lena.stadland@example.org"
    },
    "phoneNumbers" : {
      "office" : "+49 40 666666"
    }
  }
} ]

Verify the Debitor-Relation

HTTP GET "/api/hs/office/debitors?partnerNumber=P-31011" \
  -H "Authorization: Bearer $HSADMINNG_JWT_BEARER" \
  `# {` \
  `#   "sub" : "uuid<hsh-alex_superuser>"` \
  `# }`
=> status: 200 OK 
[ {
  "uuid" : "c415d0da-da9b-40c9-83f6-15f6b89c5aca", // Debitor: D-3101100 - Michelle Matthieu
  "debitorRel" : {
    "uuid" : "681e3161-a17f-42d6-9342-3f98534e783a",
    "anchor" : {
      "uuid" : "406a0fda-d67d-455f-bda8-fc208154c584", // Person: Erbengemeinschaft Michelle Matthieu-Zhang
      "personType" : "UNINCORPORATED_FIRM",
      "tradeName" : "Erbengemeinschaft Michelle Matthieu-Zhang",
      "salutation" : null,
      "title" : null,
      "givenName" : null,
      "familyName" : null
    },
    "holder" : {
      "uuid" : "406a0fda-d67d-455f-bda8-fc208154c584", // Person: Erbengemeinschaft Michelle Matthieu-Zhang
      "personType" : "UNINCORPORATED_FIRM",
      "tradeName" : "Erbengemeinschaft Michelle Matthieu-Zhang",
      "salutation" : null,
      "title" : null,
      "givenName" : null,
      "familyName" : null
    },
    "type" : "DEBITOR",
    "mark" : null,
    "contact" : {
      "uuid" : "adb4df0b-d210-4a0b-bc87-4035b754b6ae", // Contact: Michelle Matthieu
      "caption" : "Michelle Matthieu",
      "postalAddress" : {
        "zipcode" : "22123",
        "country" : "Germany",
        "city" : "Hamburg",
        "street" : "An der Wandse 34",
        "name" : "Michelle Matthieu"
      },
      "emailAddresses" : {
        "main" : "michelle@matthieu.example.org"
      },
      "phoneNumbers" : {
        "mobile" : "+49 152 1234567"
      }
    }
  },
  "debitorNumber" : "D-3101100",
  "debitorNumberSuffix" : "00",
  "partner" : {
    "uuid" : "c3c80fe5-c6e0-4e11-9b63-e472fc768e2c", // Partner: P-31011
    "partnerNumber" : "P-31011",
    "partnerRel" : {
      "uuid" : "ed2fbf99-b83d-4513-88dc-18d8229017cf",
      "anchor" : {
        "uuid" : "bb7b76f1-1922-46aa-8c22-468c70c3a9fa", // Person: Hostsharing eG
        "personType" : "LEGAL_PERSON",
        "tradeName" : "Hostsharing eG",
        "salutation" : null,
        "title" : null,
        "givenName" : null,
        "familyName" : null
      },
      "holder" : {
        "uuid" : "406a0fda-d67d-455f-bda8-fc208154c584", // Person: Erbengemeinschaft Michelle Matthieu-Zhang
        "personType" : "UNINCORPORATED_FIRM",
        "tradeName" : "Erbengemeinschaft Michelle Matthieu-Zhang",
        "salutation" : null,
        "title" : null,
        "givenName" : null,
        "familyName" : null
      },
      "type" : "PARTNER",
      "mark" : null,
      "contact" : {
        "uuid" : "baf9230c-0999-4738-9bae-8f672fb03f9d", // Contact: Erbengemeinschaft Michelle Matthieu-Zhang
        "caption" : "Erbengemeinschaft Michelle Matthieu-Zhang",
        "postalAddress" : {
          "zipcode" : "22987",
          "country" : "Germany",
          "city" : "Hamburg",
          "street" : "Im Wischer 14",
          "name" : "Erbengemeinschaft Michelle Matthieu-Zhang",
          "co" : "Lena Stadland",
          "whatever" : "any key is allowed here"
        },
        "emailAddresses" : {
          "main" : "lena.stadland@example.org"
        },
        "phoneNumbers" : {
          "office" : "+49 40 666666"
        }
      }
    },
    "details" : {
      "uuid" : "c4d07944-1979-4ceb-970d-48ff83b3acb5",
      "registrationOffice" : null,
      "registrationNumber" : null,
      "birthName" : "Eichbaum",
      "birthPlace" : "Neustadt a.d.R.",
      "birthday" : "1951-03-25",
      "dateOfDeath" : null
    }
  },
  "billable" : true,
  "vatId" : null,
  "vatCountryCode" : null,
  "vatBusiness" : false,
  "vatReverseCharge" : false,
  "refundBankAccount" : null,
  "defaultPrefix" : "mim"
} ]

generated on 2026-07-17 01:44:28 for branch